<html>

<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Bug Tracker</title>
<link rel="STYLESHEET" type="text/css" href="style.css" />
</head>

<body>

<p align="center"><tt class="chtitle1">Bug Tracker Handbook</tt></p>

<table border="0" cellpadding="0" cellspacing="0" width="100%">
  <tr>
    <td width="16%" align="left" valign="bottom"><a href="01_introduction.htm">Prev<br>
    Introduction</a></td>
    <td width="56%" valign="bottom">&nbsp;</td>
    <td width="20%" nowrap align="right" valign="bottom">
    <a href="03_administrating.htm">Next<br>
    Administrating Bug Tracker</a></td>
  </tr>
</table>

<hr>

<p><tt class="chtitle1">Chapter 2 Installation</tt></p>

<p><tt class="chtitle4">Table of Contents</tt></p>

<blockquote>

<p>2.1 <a href="#2.1">System requirements</a></p>

<p>2.2 <a href="#2.2">Configure Bug Tracker</a></p>

<p>2.3 <a href="#2.3">Setup the customer feedback system</a></p>

<p>2.4 <a href="#2.4">Upgrade</a></p>

</blockquote>

<p><a name="2.1"><tt class="chtitle2">2.1 System requirements</tt></a></p>

<p><tt class="chtitle4">Server</tt></p>

<ul>
  <li>Web server</li>
  <li>PHP after 4.3.0</li>
  <li>PostgreSQL after 7.4 or MySQL after 4.1</li>
</ul>

<p>PostgreSQL is recommended. It has better support on transaction. It is 
recommended to use PostgreSQL, 7.4.x or 8.0.x.</p>
<p>If you are using MySQL, 4.1.x is recommend (That&#39;s the only version I 
tested). You should compile MySQL to support UTF8 Character Set so we can get 
better result on sorting. If you need to upload files over 1 MB,&nbsp; besides 
the restriction on PHP (default is 2 MB), you would have to enlarge the 
communication packet of MySQL. A communication packet is a single SQL statement 
sent to the MySQL server. The default is 1 MB. You can increase this by adding 
the 
option <tt class="userinput">--max_allowed_packet=16M</tt>  
when start mysqld.</p>

<p><tt class="chtitle4">Client</tt></p>

<ul>
  <li>Web browser with JAVA script support (Some functions might be disabled 
  with JAVA script support)</li>
</ul>

<p><a name="2.2"><tt class="chtitle2">2.2 Configure Bug Tracker</tt></a></p>

<p>It is very easy to setup Bug Tracker. Here are the steps:</p>

<ul>
  <li>Download the Bug Tracker</li>
  <li>Un-tar to your web document root</li>
  <li>Edit the bug/include/config.php</li>
  <li>Connect to <a href="http://your.ip.com/bug/setup/index.php">
  http://your.domain.com/bug/setup/index.php</a> and follow the wizard.</li>
</ul>

<p>After Un-tar the Bug Tracker to your web document root, you would have to 
edit the config.php before connecting to the setup wizard. Here is the <tt class="filename">include/config.php</tt>:</p>

<table border="1"  width="600">
  <tr>
    <td width="100%"><pre class="screen">&lt;?
$GLOBALS[&#39;BR_dbserver&#39;] = &quot;127.0.0.1&quot;; // IP Address of database server
$GLOBALS[&#39;BR_dbuser&#39;] = &quot;pgsql&quot;; // User name to access the database
$GLOBALS[&#39;BR_dbpwd&#39;] = &quot;password&quot;; // Database password
$GLOBALS[&#39;BR_dbname&#39;] = &quot;bugdb&quot;; // Database name for bug tracker

/* Real path of bug tracker project */
$GLOBALS[&quot;SYS_PROJECT_PATH&quot;] = &quot;/usr/local/apache/htdocs/bug&quot;;

/* The path of URL. If you have to connect to the Bug Tracker by
 * http://192.168.0.1/bug/index.php, you should input &quot;/bug&quot; here.
 */
$GLOBALS[&quot;SYS_URL_ROOT&quot;] = &quot;/bug&quot;;
?&gt;</pre></td>
  </tr>
</table>

<p>After editing the file above, you can use the browser to connect to the setup 
wizard <tt class="filename">setup/index.php</tt> by <a href="http://your.ip.com/bug/setup/index.php">
http://your.domain.com/bug/setup/index.php</a>. Notice that the &quot;/bug/setup/index.php&quot; 
depends on your path of Bug Tracker.</p>

<p>Now you just have to follow the on-screen instructions to finish the 
installation. After finished, you can connect to Bug Tracker by
<a href="http://your.ip.com/bug/index.php">http://your.domain.com/bug/index.php</a>. 
The username of the administrator is &quot;admin&quot; and the default password is &quot;admin&quot;, 
too. You can change the password after login.</p>

<p>That&#39;s all. It&#39;s easy, isn&#39;t it?</p>

<p>Notice: Once you have finished quick setup, please remove the &quot;setup/*.php&quot; 
unless you would like to add more localized language. To localize to your 
language, please refer to chapter 5. Please do not remove the directory &quot;setup/sql&quot;.</p>

<p><a name="2.3"><tt class="chtitle2">2.3 Setup the customer feedback system</tt></a></p>

<p>You can skip this chapter if you do not need a customer feedback interface. 
To setup a customer feedback system or anonymous feedback system, all you 
have to do is just edit the <tt class="filename">feedback_site/include/config.php</tt> to configure the 
database information. After that, you can connect to the feedback system by
<a href="http://your.ip.com/bug/feedback_site/index.php">
http://your.domain.com/bug/feedback_site/index.php</a>. You can add new customers or 
just open for anonymous feedback. Please refer to chapter 4.3 for further 
information.</p>

<p>The feedback system can be completely separate from the Bug Tracker. You can 
move the &quot;feedback_site&quot; directory to another web server or another directory if you 
want. For example, you can move the &quot;feedback_site&quot; directory to the web 
document root and rename to &quot;feedback&quot;. Then you can access the feedback system 
by <a href="http://your.ip.com/feedback/index.php">
http://your.domain.com/feedback/index.php</a>. </p>

<p><a name="2.4"><tt class="chtitle2">2.4 Upgrade</tt></a></p>
<p>If you are upgrading from older version, please follow these steps:</p>

<ul>
  <li>Download the Bug Tracker</li>
  <li>Un-tar to your web document root</li>
  <li>Edit the bug/include/config.php</li>
  <li>Connect to <a href="http://your.ip.com/bug/setup/index.php">
  http://your.domain.com/bug/setup/upgrade.php</a> and follow the wizard.</li>
</ul>

<hr>
<table border="0" cellpadding="0" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="100%" id="AutoNumber1">
  <tr>
    <td width="20%" valign="top"><a href="01_introduction.htm">Prev<br>
    Introduction</a></td>
    <td width="60%" valign="top">
    <p align="center"><a href="index.htm">Index</a><br>
    This document can be downloaded from 
    <a href="http://www.twbsd.org">http://www.twbsd.org</a>. </td>
    <td width="20%" nowrap align="right" valign="top">
    <a href="03_administrating.htm">Next<br>
    Administrating Bug Tracker</a></td>
  </tr>
</table>

</body>

</html>